

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>Create Toolbox Profiles [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, Toolbox,Toolbox Profile, Create In MDG Technology,Create,Create Toolbox Profile In MDG Technology">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">Create Toolbox Profiles</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="custom_toolboxes.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="toolbox_page_attributes.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_BodyText"><span class="f_BodyText">You can create multiple toolbox profiles within an MDG Technology. Each toolbox profile contains definitions that determine what appears in the Enterprise Architect UML </span><span class="f_UIControl">Toolbox</span><span class="f_BodyText"> when a specific </span><span class="f_UIControl">Toolbox</span><span class="f_BodyText"> page is open, either by selecting from the </span><span class="f_MenuKeyField">More tools</span><span class="f_BodyText">... option in the Enterprise Architect UML </span><span class="f_UIControl">Toolbox</span><span class="f_BodyText"> window, or by opening or creating a diagram of the type that is linked to the toolbox profile.</span></p>
<p class="p_BodyText"><span class="f_BodyText">To create a toolbox profile, follow the steps below:</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=1><span class="f_NumberedList">Create a diagram in a profile package. Give it a name by which you can refer to it later, such as </span><span class="f_NumberedList" style="font-style: italic;">MyClassDiagram</span><span class="f_NumberedList">. In the </span><span class="f_MenuKeyField">Notes</span><span class="f_NumberedList"> field for the diagram give it an alias and a description in the following format:</span></li>
</ol>
<p class="p_Code" style="margin: 0px 0px 0px 49px;"><span class="f_Code">Alias=MyClass;Notes=Structural elements for class diagrams;</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=2><span class="f_NumberedList">On the diagram, create a Class, name it </span><span class="f_NumberedList" style="font-style: italic;">ToolboxPage</span><span class="f_NumberedList"> and give it the </span><span class="f_NumberedList">&laquo;</span><span class="f_NumberedList" style="font-style: italic;">metaclass</span><span class="f_NumberedList">&raquo;</span><span class="f_NumberedList"> stereotype.</span></li>
<li value=3><span class="f_NumberedList">Create a </span><span class="f_NumberedList">&laquo;</span><span class="f_NumberedList" style="font-style: italic;">stereotype</span><span class="f_NumberedList">&raquo;</span><span class="f_NumberedList"> element for each of the toolbox pages to create within your toolbox, such as </span><span class="f_NumberedList" style="font-style: italic;">MyClassElements</span><span class="f_NumberedList"> and </span><span class="f_NumberedList" style="font-style: italic;">MyClassRelationships</span><span class="f_NumberedList">. Set their Alias to the text to display in the title bar of each toolbox page, such as </span><span class="f_NumberedList" style="font-style: italic;">My Class Elements</span><span class="f_NumberedList"> and </span><span class="f_NumberedList" style="font-style: italic;">My Class Relationships</span><span class="f_NumberedList"> respectively. Use the </span><span class="f_MenuKeyField">Notes</span><span class="f_NumberedList"> field to define the tool-tip for each toolbox page; that is, </span><span class="f_NumberedList" style="font-weight: bold;">Elements for Class Diagrams</span><span class="f_NumberedList"> and </span><span class="f_NumberedList" style="font-weight: bold;">Relationships for Class Diagrams</span><span class="f_NumberedList">. Use the </span><span class="f_NumberedList">&laquo;</span><span class="f_NumberedList" style="font-style: italic;">extends</span><span class="f_NumberedList">&raquo;</span><span class="f_NumberedList"> connector to set the stereotype elements to extend </span><span class="f_NumberedList" style="font-style: italic;">ToolboxPage</span><span class="f_NumberedList">. See also: <a href="toolbox_page_attributes.htm">Toolbox Page Attributes</a>.</span></li>
<li value=4><span class="f_NumberedList">In the </span><span class="f_NumberedList">&laquo;</span><span class="f_NumberedList" style="font-style: italic;">stereotype</span><span class="f_NumberedList">&raquo;</span><span class="f_NumberedList"> elements, create an attribute for each toolbox item. The name of the attribute should be the name of the element or connector to be dropped, including namespace, e.g. </span><span class="f_NumberedList" style="font-style: italic;">UML::Package</span><span class="f_NumberedList">, </span><span class="f_NumberedList" style="font-style: italic;">UML::Class</span><span class="f_NumberedList"> and </span><span class="f_NumberedList" style="font-style: italic;">UML::Interface</span><span class="f_NumberedList">. The toolbox items display in the same order as the attributes in the Class, so make use of the attribute ordering buttons to define the order of your toolbox.</span></li>
</ol>
<div style="text-align: left; text-indent: -21px; padding: 0px 0px 0px 0px; margin: 5px 0px 0px 48px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="952" bgcolor="#efeff7" style="width:952px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td bgcolor="#f7f7ff" style="background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">To name an attribute for an item from your own technology, precede it with your profile name as the namespace, and then follow it in brackets with the element or connector type that you are extending (so that Enterprise Architect knows what object to create). For example, a SysML block element would appear as </span><span class="f_TiporNoteText" style="font-style: italic;">SysML::Block(UML::Class)</span><span class="f_TiporNoteText">. Click on the following links for a complete list of <a href="elements_used_in_toolboxes.htm">elements</a> and <a href="connectors_used_in_toolboxes.htm">connectors</a> that can be extended.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_NumberedList"><span class="f_NumberedList">&nbsp;</span><br>
<span class="f_NumberedList">To define a toolbox item that allows a pattern to be dropped onto a diagram, name the attribute </span><span class="f_NumberedList" style="font-style: italic;">MyTechnology::MyPattern(UMLPattern)</span><span class="f_NumberedList"> where </span><span class="f_NumberedList" style="font-style: italic;">MyTechnology</span><span class="f_NumberedList"> is the name of the technology and </span><span class="f_NumberedList" style="font-style: italic;">MyPattern</span><span class="f_NumberedList"> is the name of the pattern to drop. For example, </span><span class="f_NumberedList" style="font-style: italic;">GoFPatterns::Builder(UMLPattern)</span><span class="f_NumberedList">.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<span class="f_NumberedList">You might not want to use names such as </span><span class="f_NumberedList" style="font-style: italic;">UML::Package</span><span class="f_NumberedList"> or </span><span class="f_NumberedList" style="font-style: italic;">UML::Class</span><span class="f_NumberedList"> in your toolbox, so give the attributes an </span><span class="f_MenuKeyField">Initial Value</span><span class="f_NumberedList"> of, for example, </span><span class="f_NumberedList" style="font-style: italic;">Package</span><span class="f_NumberedList"> or </span><span class="f_NumberedList" style="font-style: italic;">Class</span><span class="f_NumberedList">.</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=5><span class="f_NumberedList">To save the toolbox profile, right-click the diagram and select the </span><span class="f_MenuKeyField">Save as Profile</span><span class="f_NumberedList"> context menu option.</span></li>
</ol>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Incorporate Toolbox in MDG Technology</span></p>
<p class="p_BodyText"><span class="f_BodyText">To incorporate your Toolbox profile in an MDG Technology, modify the MTS file that you use to create your MDG Technology and then rebuild the MDG Technology. For further information, see <a href="working_with_mts_files.htm">Working With MTS Files</a> (the </span><span class="f_Code">&lt;UIToolboxes directory=&quot;&quot; files=&quot;&quot;/&gt;</span><span class="f_BodyText"> line).</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="952" bgcolor="#efeff7" style="width:952px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td bgcolor="#f7f7ff" style="background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">Each profile element incorporated into an MDG </span><span class="f_UIControl">Toolbox</span><span class="f_TiporNoteText"> page enables <a href="synchronizetagsandconstrain.htm">synchronization</a> of the Tagged Values and Constraints of all elements created from them.</span></p>
</td>
</tr>
</table>
</div>




            </div>
          </div>
        </div>



</div>


</body>
</html>
